Create User

Creates a new user in the tenant and assigns licenses and project roles as specified.

POST{accelqLoginUrl}/awb/api/2.0/{tenantCode}/administration/users

Headers

HeaderValue
user_idLogin username (email)
api_keyAPI key of the user for authentication
Content-Typeapplication/json
Acceptapplication/json

Parameters

ParameterTypeRequiredDescription
accelqLoginUrlstringYesThe AccelQ login URL for API access.
tenantCodestringYesTenant code for identifying the organization.
user_idstringYesLogin username (email)
api_keystringYesAPI key of the user for authentication

Request Body

json
{
  "firstName": "Test",
  "lastName": "User4",
  "email": "Testuser4@accelq.com",
  "tenantAdmin": false,
  "authType": "SSO",
  "ssoId": "DemoUser@gmail.com",
  "assignedLicenses": [
    {
      "subscriptionId": 172415678689826,
      "licenseBundleId": "2"
    }
  ],
  "assignedProjects": [
    {
      "projectName": "AccelqPROJECT",
      "roleName": "SME",
      "isAdmin": false
    }
  ]
}

Responses

201 - User successfully created

json
{
  "userPid": "25",
  "firstName": "Test",
  "lastName": "User4",
  "email": "Testuser4@accelq.com",
  "active": true,
  "tenantAdmin": false,
  "assignedLicenses": [
    {
      "subscriptionId": "1724156779826",
      "subscriptionName": "1724156779826",
      "licenseBundleId": 2,
      "products": [
        "WEB",
        "API"
      ],
      "subscriptionType": "Commercial"
    }
  ],
  "assignedProjects": [
    {
      "projectName": "AccelqPROJECT",
      "roleName": "SME",
      "isAdmin": false
    }
  ]
}

400 - Bad Request Error

json
{
  "error": "Invalid email address format"
}

403 - Forbidden - User does not have permission to create users

json
{
  "error": "User does not have authorization to access this feature"
}

cURL Command Builder

URL Parameters

Headers

Request Sample (cURL)

curl -X POST "${{accelqLoginUrl}}/awb/api/2.0/${{tenantCode}}/administration/users" \
  -H "user_id: ${{user_id}}" \
  -H "api_key: ${{api_key}}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
  "firstName": "Test",
  "lastName": "User4",
  "email": "Testuser4@accelq.com",
  "tenantAdmin": false,
  "authType": "SSO",
  "ssoId": "DemoUser@gmail.com",
  "assignedLicenses": [
    {
      "subscriptionId": 172415678689826,
      "licenseBundleId": "2"
    }
  ],
  "assignedProjects": [
    {
      "projectName": "AccelqPROJECT",
      "roleName": "SME",
      "isAdmin": false
    }
  ]
}'